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A 6502 Disassembler from Apple 



by Steve Wozniak & Allen Baum 

Apple Computer Co., 770 Welch Rd., No. 154 
Palo Alto CA 94304; (415) 326-4248 

DESCRIPTION 

Tliis subroutine package is used to display single or 
sequential 6502 instructions in mnemonic form. The sub- 
routines are tailored to disassemblers and debugging aids, 
but tables with more general usage (assemblers) are in- 
cluded. The subroutines occupy one page (256 bytes) and 
tables most of another. Seven page zero locations are used. 

FEATURES 

Four output fields are generated for each disassem- 
bled instruction: 1) Address of instruction, in hexadecimal 
(hex); 2) Hex code listing of instruction. 1 to 3 bytes; 
3) 3-character mnemonic, or "???" for invalid ops (which 
assume a length of 1 byte); and 4) Address field, in one 
o( the following formats. 



Format 

(empty) 

S12 

S1234 

#SI2 

S12.X 

SI2.Y 

S1234,X 

S1234,Y 

(SI 234) 

(SI2.X) 

(S12).Y 

Note 
which use 



Address Mode 

Invalid, Implied, Accumulator 

Page zero 

Absolute, Branch (target printed) 

Immediate 

Zero page, indexed by X 

Zero page, indexed by Y 

Absolute, indexed by X 

Absolute, indexed by Y 

Indirect 

Indexed Indirect 

Indirect Indexed 



that unlike MOS TECHNOLOGY assemblers, 
4 A" for accumulator addressing, the APPLE 

disassembler outputs an empty field to avoid confusion and 

facilitate byte counting. 



USAGE 
The 

DSMBL 



following subroutine entries are useful. 

Disassembles and displays 20 sequential instruc- 
tions beginning at the address specified by the 
page zero variables PCL and PCH. For example, 
if called with SD2 in PCL and S38 in PCH, 20 
instructions beginning at address S38D2 will be 
disassembled. PCL and PCH are updated to con- 
tain the address of the last disassembled in- 
struction. Must be called with 6502 in hexa- 
decimal mode ('D' status bit clear). All proces- 
sor registers are altered (except S-stack pointer). 
Uses INSTDSP and PCADJ. 

INSTDSP Disassembles and displays a single instruction 
whose address is specified by PCL and PCH. 
Must be called in hexadecimal mode. All pro- 
cessor registers (except S) are altered. Uses 
PCADJ3, PRPC, PRBLNK, PRBL2, PRNTAX, 
PRBYTE, and CHAROUT. 

PRPC Outputs a carriage return, 4 hex digits corres- 

ponding to PCH and PCL, a dash, and 3 blanks. 
Alters A, clears X. Uses PRNTAX and 
CHAROUT. 

PRNTX Outputs the contents of X as two hex dirits. 
Alters A. Uses CHAROUT. 

PRNTAX Outputs two hex digits for the contents of A, 



PRNTYX 
PRBLNK 
PRBL2 

PRBL3 
PCADJ 



PCADJ2 
PCADJ3 



then two hex digits for the contents of X. A 
is altered. Uses CHAROUT. 
Same as PRNTAX except that Y and X are 
output. Alters A. Uses CHAROUT. 
Outputs 3 blanks. Alters A, clears X. Uses 
CHAROUT. 

Outputs the number of blanks specified by the 
contents of X (0 for 256 blanks). Alters A, 
clears X. Uses CHAROUT. 
Outputs a character from the A register fol- 
lowed by X-l blanks. In other words, X speci- 
fies the total number of characters output. (0 
for 256 blanks). Alters A, clears X. Uses 
CHAROUT. 

(PCL,PCH) + 1 + (contents of page zero variable 
LENGTH) -+Y & A (low order byte in Y). For 
example, if PCL = SD2, PCH = $38, and 
LENGTH = 1 (corresponding to a 2 byte instruc- 
tion), PCADJ will leave Y = $D4 and A = $38. 
X is always loaded with PCH. 
Same as PCADJ except that A is used in place 
of LENGTH. 

Same as PCADJ2 except that the increment 
(+1) is specified by the carry (set = +1, 
clear = +0). 



RUNNING AS A PROGRAM 

The following program will run a disassembly. 

Supplied on apple-i r 9F0 20 8 JSR DSMBL 
cassette tapes. 1 9F3 4C1FFF JMP MONITOR 



First, put the starting address of code you want dis- 
assembled in PCL (low order byte) and PCH (high order 
byte). Then type 9F0 R CR (on APPLE-1 system). 20 
instructions will be disassembled. Hitting R CR again will 
give the next 20, etc. 

Cassette tapes supplied for the ACI-1 (APPLE Cas- 
sette Interface) are intended to be loaded from $800 to 
S9FF. 

NON-APPLE SYSTEMS 

Source and object code supplied occupies pages 8 and 
9. All code is on page 8, tables are on page 9. These 
tables may be relocated at will: MODE, MODE2, CHAR1, 
ChAR2, MNEML, and MNEMR. The code may also be 
relocated. Be careful if you use pages or 1. Page 1 is 
the subroutine return stack and page must contain 7 
variables (to use DSMBL). These may be relocated on page 
but PCL must always immediately precede PCH for 
(Z-page), Y addressing. 



locations 

used 

by 

supplied 

code 



S40 
S41 
$42 
{$43 
$44 
$45 
$46 



1 INSTDSP, 



FORMAT Used 
LENGTH 
LMNEM 
RMNEM dsmbl 

PCL -» Used by PCADJ, 
PCH i INSTDSP, DSMBL 
COUNT }Used by DSMBL only 



MODIFICATIONS 

a) To change *#* to '=' for immediate mode change 
location $955 (on code enclosed) from a $A3 to a $BD. 

b) To skip the '$' (meaning hex) preceding disas- 
sembled values make the following changes: 
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946: 01 (was 81) 














947: 02 (was 82) 








LL.' 




X • Cu LU 1— - 


94C: 11 (was 91) 












h- LU _l O • _J -X LU 
O ^-i Cu o Cu X 1— 


94D: 12 (was 92> 








_i 


Ct 


cm • • o x .=■ .x tt- :- 

a i=i x l_ . — o h- o cu i— 

-J — ' — • LlC 1=1 JH LL 1 W 


94E: 06 (was 86) 








CCi i- 


r^ 


cci _i _j '.•:■ • x u o ■.■:■ • x i- — lu 
c ~ ~ x ■-.'". h- c =< lu x .'• ::• x r q ii ■ i— 


950: 05 (was 85) 








•to 3 

■=• Cu 


i— 


• '.■".' ;=■ "■■ LJ LU JO . • LU X LU X _l C ' LU 

•X' Q x x ct .<:>< tt lu x a x lu : : c* — • s cl lu k- C' 


951: ID (was 9D) 








Ct — 


iu 


Lt •— •— <-i Lu C> CU CO LU 'j'.' LU X> X O •— > — • 
t— LU HlLLL OIJQ ". O '_:• Ct <-> lu Lu • Cu O 


95B: 00 (was A4) 








H- C=( 


- 


•-•"■ '-0 i±: Ct 'X ■_' t— O'.i X lu-O X 1 -^ 

=r -J • »- >- :- o:- u uj -< or — c lu h- i- <j> i- co x 


95C: 00 (was A4) 








•r 


o 


«-■ LU *— •-•'• '.'"• Ct L3 Ct LU Lt '.0 X "X X CO 'JJ II X 

'.'"• ZZ X '_' X Ct h- i-i X' »— LU 1— i=< C X « LU X CM X 

■7^ LU —* •— LU — • 'X <=t X _J •— — • CO Ct Lt : Ct LU ^ 


c) To have address field of accumulator-addressed 


o"j LU 
_l 


X 

_J 


-< • • . ►- ::oni-c >_• cu _j *n o lqu » 

Ct X LU • — — •>:> LUXLUCt lOCLL i=t LU ill 

y- o - i=i ci — — • .x h- =. o l? C".o o :- T ::• LU O I h h . o • 


instructions Drint as *A\ 

l) Must skip $ preceding 








o X 


J£' 


'.••■ ojo >=t cu : -; :.«;hMK u. ct x t— t— t— —• : - lu lu h- 
ct _i <_> <_> o x — • cu •— > x ct : x :- ct' Ct >-• x- x zlcccilCio ►-• 


disassembled values 


U. UJ 


LU 


— Cu s »- X O -- ■-. -i Ct - 1- iX C h- " -- O 1 1 O K- 

lu •■ cu x '..'• : : C" ?•■> »-i v- ct: x <_• u. ct •-* ct u. '"••j '*■•] o •-• lu 


by making modification b) above. 




X 'X 


I 


:•■■ i— o uj uj : : o =i cu u. : •: x •-< o i— a. : c n ~> 

LU LU X > 1— X — ii 'X '.<"' LU LU Cj Cl" • U. li Lu CO LU LU ji —• Ct iL 'X 


2) Change the following 


ocations: 






■3 Q 


| 


X 1- — 1— LU '.0 1 i i — t Ci. .—i i.O Cu t— =. '.-• ■.'"• ' — ' ■'■'' CO 

X" tt LU -X X Lu X O X" LU X 'X 'X 'X 

=4 :♦• Ou 'JJ ■*■ + ■*• ♦ x : +: f •*■ mhi :«/ x *n i.o co >-t co x: •+; ;♦ x: * 


949: 80 (was 00] 














957: CI (was A4) 












d) To add ROR and addressing modes, 


change 


the 








following locations' 








tu 




^ 


991: 9C (was 00) 
9D1: 26 (was 00) 




4 T 


-J >••■• T U-' 
T *T *T T 


'_• Lu 

<=4 LU 

>L< U. LL. 

tL-LL 




■••j :: x lu v- '.">- x 

t- _J - X - =. X ■'■) -X t~ 

X Cu i_' _J LU «"■! O LU O U. C' LU X ' i Lu 
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X '.'.. Ct Cu LU Ct — Ct »n »-» '_. h- Vt LU *n »n O O "i U «n 


919: 02 (was 00) 
91A: 45 (was 40) 




*-» *T 


♦n *» *n *n 


*n U. *^ 


^ at 3i « cL d. cL 


'-' u Cl - X — "X Lu =t LU at =s X X Ct ; X 'X 'X 'X at iji at at X Ll at _i q* 
















91B: B3 (was B0) 
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- X X- X- 


X X x. 
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91D: 08 (was 00) 
91 F: 09 (was 00) 




• • :•< ■■! 1 1 ' i , ' ii i 1 1 1 iit iii ii ) 


z- _i '.>•• -.. - 
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_ _. 
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